<h2>DESCRIPTION</h2>

<em>d.rast.num</em>
overlays cell category values onto a raster map layer displayed
on the user's graphics monitor.

Category values will be displayed in the text color given and scaled
to fit within a single cell. A grid outlining each map cell will also 
be overlain in a user-specified color, unless it has been set to "none".

<p>If no grid color is given the default will be used. If no map layer
is specified, the program will use whatever raster map layer is
currently displayed in the active frame on the graphics monitor.
<p>If the <b>-f</b> flag is given the displayed number will take on the color 
of the base map in that cell.


<h2>NOTES</h2>

The user is advised to set the current region to a relatively
small area (i.e., less than 100 rows by 100 columns);
otherwise, the individual cells being displayed will be small
and the category value associated with each will be difficult to see.
No data cells are indicated with "Null".

<h2>EXAMPLE</h2>

A) Distance from the streams network (North Carolina sample dataset):
<div class="code"><pre>
g.region raster=streams_derived -p
r.grow.distance input=streams_derived distance=dist_from_streams
d.rast.num dist_from_streams -a
</pre></div>

<div align="center" style="margin: 10px">
<img src="d_rast_num_zoom.png" border=0><br>
<i>Euclidean distance from the streams network in meters (detail, numbers shown
   with d.rast.num)</i>
</div>

<h2>SEE ALSO</h2>

<em>
<a href="d.frame.html">d.frame</a>,
<a href="d.grid.html">d.grid</a>,
<a href="d.rast.html">d.rast</a>,
<a href="d.rast.arrow.html">d.rast.arrow</a>,
<a href="d.rast.edit.html">d.rast.edit</a>,
<a href="g.region.html">g.region</a>,
<a href="r.slope.aspect.html">r.slope.aspect</a>
</em>


<h2>AUTHORS</h2>

Raghavan Srinivasan,
and Chris Rewerts,<br>
Agricultural Engineering, Purdue University

<!--
<p>
<i>Last changed: $Date$</i>
-->
